X3D-Edit for Extensible 3D (X3D) Graphics

Don Brutzman (mailto:brutzman@nps.navy.mil(Don%20Brutzman)?subject=X3D-Edit feedback)

Purpose | Status | Internationalization (i18n) | Installation Setup | Download Updates | Features | Details | Usage | Compact Form | Developers | Bugfixes

Installation Setup

This software is available on the X3D Software Development Kit (SDK), CD volume II under Tools.

1. Install one of these free Virtual Reality Modeling Language (VRML) plugins in your web browsers. These plugins can work with any combination of Netscape and Internet Explorer.

   • CosmoPlayer 2.1.1 (~3MB)
   • Karmanaut mirror site: CosmoPlayer 2.1.1 plugin for Netscape or Internet Explorer. (~3MB)
   • Cortona 3.1 by Parallel Graphics
   • Contact 5.0 by blaxxun interactive
   • Pivoron by Nexternet

   To see if your VRML-browser installation worked, try viewing the HelloWorld.wrl example scene.

2. Install Java using one of the following distributions. (Java is needed in order to run the Xeena tool.) When installing, you will need to acknowledge the nonrestrictive Java license.

   You might save a download if Java is is already installed. You can test whether Java is installed by opening a command window and typing

   		c:\>  java -version
   

   • Java JRE 1.3.1 (also called Java Run-Time Environment Version 1.3.1)
     • ~5MB
     • http://java.sun.com/j2se/1.3/jre
     • Usually Java goes in c:\Program Files\JavaSoft\JRE\1.3.1_02
     • Only allows running Java classes, which is sufficient to run X3D-Edit/Xeena

     OR

   • Java JDK 1.3.1 (also called Java 2 SDK, Standard Edition Version 1.3.1)
     • ~30MB
     • http://java.sun.com/j2se/1.3
     • Usually Java goes in c:\jdk1.3.1_02
     • Also provides development environment for compilation, debugging etc.

3. Download and install Xeena from IBM Alphaworks http://www.alphaWorks.ibm.com/tech/xeena (~5MB).

   Make sure that you retrieve version 1.2EA, not version 1.1. Xeena is used to build to the X3D-Edit tool.

   • You need to acknowledge the nonrestrictive licenses.
   • It is best to stick with the default installation C:\IBM\Xeena subdirectory.
   • When Xeena asks for which version of Java to use, select Java 2 (Runtime Environment or SDK).
   • Then point the installer to the destination directory where you installed Java (typically C:\jdk1.3.1, not C:\jdk1.3.1\bin).
   • No "proxy host" entry is needed, this is for use behind restrictive firewalls.
   • Default values on other entries work fine.
   • Go ahead and view the example "addressbook" example. If you get an "Out of environment space" error, see the bugfix below.
   • Once installed, Xeena details can be found on the Help (user guide) page, installation README page, and Frequently Asked Questions (FAQ) pages.
   • Once installed, test installation by running the Xeena AddressBook DTD Example.

4. If you need an unzip program, get PKZIP (from http://www.pkware.com/).

   Make sure your unzip program's preferences install the zip into your top-level directory on C:\ and preserve all subdirectory folder names (the X3D-Edit code unravels/merges everything into C:\www.web3D.org\TaskGroups\x3d\translation\* )

   You can also unzip a zipfile using Java as follows. Be sure to run this from your topmost (root) subdirectory.
      C:\> jar -xvf X3D-Edit.zip

   Download Updates

5. Download the X3D-Edit distribution (~1.2 MB) from
   http://www.web3D.org/TaskGroups/x3d/translation/X3D-Edit.zip or
   http://www.web3D.org/TaskGroups/x3d/translation/X3D-Edit.tar.gz

6. Recommended installation: download the X3D-Examples distribution (~25 MB) from
   http://www.web3D.org/TaskGroups/x3d/translation/X3D-Examples.zip or
   http://www.web3D.org/TaskGroups/x3d/translation/X3D-Examples.tar.gz

   Unzip from your top-level directory as follows:
   C:\> jar -xvf X3D-Examples.zip

   Again, make sure your unzip preferences preserve the subdirectory folder names and install the zip into your top-level directory on C:\ (it unravels into C:\www.web3D.org\TaskGroups\x3d\translation\* )

   The X3D Examples are also viewable online at http://www.web3D.org/TaskGroups/x3d/translation/examples/contents.html.

7. Recommended installation: download the NIST Conformance Examples distribution (~10 MB) from
   http://www.web3D.org/TaskGroups/x3d/translation/ConformanceExamples.zip

   The NIST Conformance Examples are also viewable online at http://www.web3D.org/TaskGroups/x3d/translation/examples/Conformance/contents.html.

   Unzip from your top-level directory as follows:
   C:\> jar -xvf ConformanceExamples.zip

8. For GeoVRML extension support, you must also install GeoVRML.

9. For DIS-Java-VRML extension support, you must also install DIS-Java-VRML.

10. All done! Time to run X3D-Edit. See Usage for further directions. See Bugfixes if you've encountered trouble.

Revised: 2 April 2002 Maintained by Don Brutzman (brutzman@nps.navy.mil)

This page is available online at http://www.web3D.org/TaskGroups/x3d/translation/README.X3D-Edit.html